home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / lang_c / artool / artool.doc < prev    next >
Text File  |  1992-02-09  |  21KB  |  925 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                         ARTOOL
  31.                                      Version 1.3
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                                  Copyright 1991,1992
  45.                                    SunSet Software
  46.                                     34 Ridge Road
  47.                                 Oak Ridge, NJ   07438
  48.                                    (201) 697 - 1629
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.              ARTOOL - Version 1.3                                  2/9/92
  72.  
  73.  
  74.                                         LICENSE
  75.  
  76.  
  77.              All versions of SunSet Software's ARTOOL are not public
  78.              domain software, nor is it free software.  ARTOOL is
  79.              copyright (C) 1991,1992 by SunSet Software.  Non-registered
  80.              users are granted a limited license to use ARTOOL on a trial
  81.              basis for the purpose of determining whether these programs
  82.              are suitable  for  their  needs.  Use of ARTOOL, except for
  83.              this limited purpose,  requires registration.  Use  of  non-
  84.              registered  copies  of ARTOOL by any person,  business,
  85.              corporation, governmental agency or other entity institution
  86.              is strictly forbidden.
  87.  
  88.              Registration permits a user the license to use ARTOOL. A
  89.              registered user may use the program on a different computer,
  90.              but may not use the program on more than one computer at the
  91.              same time. No user may modify ARTOOL in any way,  including
  92.              but not limited  to decompiling, disassembling  or otherwise
  93.              reverse  engineering  the program.
  94.  
  95.              All users are granted a limited license to copy ARTOOL only
  96.              for the trial  use  of  others subject to the above
  97.              limitations,  and also the following: ARTOOL must be copied
  98.              in unmodified form,  complete with the file containing this
  99.              license information. Any and all ARTOOL documentation must
  100.              be included with the copy. No  fee, charge or other
  101.              compensation may be accepted or requested by any licensee.
  102.              ARTOOL may not  be  distributed in conjunction  with  any
  103.              other product. Operators  of  electronic  bulletin  board
  104.              systems  (Sysops) may post ARTOOL for downloading by their
  105.              users only  as long as  the  above conditions are met.
  106.  
  107.              Distributors of public domain or user supported software
  108.              may distribute copies of ARTOOL subject to the above
  109.              conditions and if they charge only a nominal fee for such
  110.              distribution.
  111.  
  112.              See  the  Ordering  section  for  more  information on
  113.              registration, corporate licensing and similar topics.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                        Page - 2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.              ARTOOL - Version 1.3                                  2/9/92
  138.  
  139.  
  140.  
  141.                                        WARRANTY
  142.  
  143.              SunSet Software Computer Systems makes  no  warranty  of
  144.              any kind, express  or implied,  including without
  145.              limitation, any warranties of merchantability and/or fitness
  146.              for a particular  purpose.  SunSet Software shall not be
  147.              liable for any damages,  whether direct,  indirect,  special
  148.              or consequential arising from a failure of this program to
  149.              operate in the manner desired by the user.  SunSet Software
  150.              shall not be liable for any damage to data or property which
  151.              may be caused directly or  indirectly  by  use  of  the
  152.              program.
  153.  
  154.              IN NO EVENT WILL SunSet Software BE LIABLE TO YOU FOR ANY
  155.              DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
  156.              INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE
  157.              OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY
  158.              OTHER PARTY.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                        Page - 3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.              ARTOOL - Version 1.3                                  2/9/92
  204.  
  205.  
  206.  
  207.                                   Table of Contents
  208.  
  209.               1. New Features
  210.               2. Introduction
  211.               3. Saving Your Work
  212.               4. Moving And Editing The Graphics
  213.               5. Writing Code
  214.               6. Using the Graphics Within Your Programs
  215.               7. ARTSHOW
  216.               8. Further Information
  217.               9. Registration
  218.              10. Bugs & Suggestions
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                        Page - 4
  264.  
  265.  
  266.  
  267.  
  268.  
  269.              ARTOOL - Version 1.3                                  2/9/92
  270.  
  271.  
  272.  
  273.                              New Features In Version 1.3
  274.  
  275.              When an object is selected you can use the numeric keypad
  276.              up/ down/ right/ left arrow keys to move (in ten pixel
  277.              increments). To move the object in one pixel increments use
  278.              the above keys with the control key.
  279.  
  280.              To get the same effect as the right mouse button you can use
  281.              the numeric keypad plus key.
  282.  
  283.              To "attach" or "detach" you can also use the numeric keypad
  284.              '5' key.
  285.  
  286.              The numeric keypad Pg Up/Pg Dn keys are equivalent to the
  287.              Next and Previous buttons on the screen.  Similarly the Home
  288.              and End keys are the same as the First and Last Buttons.
  289.  
  290.              The numeric keypad plus key is the same as the right mouse
  291.              button. When modifying a polygon the minus key allows you to
  292.              go to the previous vertice.
  293.  
  294.              Included with to ARTOOL is a utility called ARTSHOW which
  295.              will display your "dot ART" files, so you can create your
  296.              own slide shows directly from the ART files.  To use it type
  297.              the following at the DOS prompt:
  298.  
  299.                              ARTSHOW filename.art
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                        Page - 5
  330.  
  331.  
  332.  
  333.  
  334.  
  335.              ARTOOL - Version 1.3                                  2/9/92
  336.  
  337.  
  338.  
  339.                                      Introduction
  340.  
  341.              Welcome to the ARTOOL the graphics editor and CASE tool.
  342.              Designed with the latest Object Oriented techniques it
  343.              provides an indispensable tool for the C graphics
  344.              programmer.
  345.  
  346.              With ARTOOL you can create sophisticated graphic displays
  347.              that you can use in your own applications.  ARTOOL skips the
  348.              tedious "edit, compile, and run" phase of writing most
  349.              graphics applications, by allowing you to directly
  350.              manipulate the graphics on the screen until it looks
  351.              perfect.  Then ARTOOL can produce 'C' code that you can
  352.              embed directly into your own Borland code for the fastest
  353.              graphics ever.
  354.  
  355.  
  356.              To start it, type
  357.  
  358.                      ARTOOL
  359.  
  360.              at the DOS prompt. Once you skip the SunSet Software Logo
  361.              (press a key) you can begin immediately to create and edit
  362.              graphics.  For example, move the mouse cursor to the Circle
  363.              graphic button (on the left of the screen) and clicking on
  364.              it.
  365.  
  366.              Then move the mouse cursor to the graphic edit window and
  367.              press the INSERT key. Now you move the circle anywhere on
  368.              the screen and "drop" it by pressing the ESC key or clicking
  369.              the left mouse button.
  370.  
  371.              Some graphics attributes of the graphic can be modified
  372.              directly on the screen. For example, the circle radius, line
  373.              lengths, polygon vertices, and rectangle sizes can be
  374.              changed using the mouse by clicking the right mouse button
  375.              and moving the mouse cursor.
  376.  
  377.              Other graphic attributes can be changed by clicking on the
  378.              buttons at the bottom of the screen.  For example, all
  379.              graphics will have a "color" button.  Click on this and a
  380.              "popup" menu of color choices will appear - click on the
  381.              color you want the graphic to have. Each type of graphic has
  382.              a different set of bottom buttons.
  383.  
  384.              You can duplicate the current graphic (or the last one you
  385.              manipulated) by pressing the INSERT key after dropping the
  386.              graphic.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                        Page - 6
  396.  
  397.  
  398.  
  399.  
  400.  
  401.              ARTOOL - Version 1.3                                  2/9/92
  402.  
  403.  
  404.                                    Saving Your Work
  405.  
  406.              When you are happy with your work, click on the "File"
  407.              choice at the top of the screen.  Then click on the "Save"
  408.              choice to save your work to a filename that you can change,
  409.              or click on "Save as..." to save your work to a file that
  410.              already exists.
  411.  
  412.              All ARTOOL data files are saved with the extension ".ART".
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                                        Page - 7
  462.  
  463.  
  464.  
  465.  
  466.  
  467.              ARTOOL - Version 1.3                                  2/9/92
  468.  
  469.  
  470.                            Moving And Editing The Graphics
  471.  
  472.              The push/pop buttons (at the left of the screen) will push
  473.              or pop the current graphic below or above its neighboring
  474.              graphics (ie. in the list of graphics).
  475.  
  476.              The First/ Next/ Previous/ Last buttons on the left of the
  477.              screen will select the First/ next/ previous/ last graphic.
  478.  
  479.              Also, the numeric keypad keys Home/ End/ Pg Up/ Pg Dn will
  480.              select the first/ last/ next/ and previous graphic too.
  481.  
  482.              Once a graphic is selected pressing the numeric keypad 5 key
  483.              will release it.
  484.  
  485.              To move a graphic you can use the arrow keys.  If you do so,
  486.              the graphic will move in ten pixel increments, if you press
  487.              the control key and the arrow key the graphic will move in
  488.              pixel increments.
  489.  
  490.              Also, for the certain graphics like the circle,line, or
  491.              polygon pressing the numeric keypad plus (+) key will toggle
  492.              you into modifying a second graphic attribute of the object
  493.              - for example pressing the plus key when a circle is selcted
  494.              will toggle you into modifying the circle radius mode (you
  495.              also use the arrow keys in this mode too).
  496.  
  497.              When you have a polygon selected pressing the plus key will
  498.              move to the next vertice, the minus (-) key to the previous
  499.              vertice. To insert a new vertice press the control key and
  500.              insert key at the same time.  To delete a vertice move to
  501.              the vertice and press the delete key.
  502.  
  503.              When a graphic is selected at the bottom of the screen will
  504.              appear a set of buttons that if clicked on will allow you to
  505.              change corresponding attributes for the selected graphic.
  506.              For example when you have a circle selected, press the left
  507.              mouse button (to drop the circle), and click on mode.  The
  508.              circle will become a solid circle.  Then press on the
  509.              pattern button, and a menu of possible patterns will appear.
  510.              Click on one of the patterns and the circle will be drawn in
  511.              the current color and pattern.
  512.  
  513.              To duplicate a graphic, select it and then press the insert
  514.              key an identical graphic (with the same attributes) will be
  515.              created.
  516.  
  517.              To delete a graphic, select it and press the delete key.
  518.              The graphic will be deleted.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.                                        Page - 8
  528.  
  529.  
  530.  
  531.  
  532.  
  533.              ARTOOL - Version 1.3                                  2/9/92
  534.  
  535.  
  536.                                      Writing Code
  537.  
  538.              When you want to generate code from the current work display
  539.              click on the "Make" choice at the top of the screen.  Then
  540.              depending on if you want a code fragment, a single function,
  541.              or a complete program you would click on "Fragment",
  542.              "Function", or "Program".
  543.  
  544.              Once selected you will be prompted with a pop-up menu for
  545.              the name of the file to write the code too.  Change the
  546.              filename from the default prompt and click on Ok, to create
  547.              the code file.
  548.  
  549.              The code that ARTOOL creates, hard codes everything except
  550.              for the X,Y origin of the collection of graphic objects.
  551.              Ie. font codes, color codes, x&y offsets, line types, etc
  552.              are written as numbers.  The absolue x,y offset of the
  553.              objects are variables passed to the ARTOOL routine.  This
  554.              allows you to use your graphics over and over again by
  555.              simply calling the ARTOOL routine with a new x,y location.
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.                                        Page - 9
  594.  
  595.  
  596.  
  597.  
  598.  
  599.              ARTOOL - Version 1.3                                  2/9/92
  600.  
  601.  
  602.                        Using The Graphics in Your Own Programs
  603.  
  604.  
  605.              To use the ARTOOL generated code in your own programs you
  606.              must compile and link the ART 'C' code with your programs.
  607.              Also, you must compile and link with the supplied 'C'
  608.              program ART.C if your graphics use polygons.
  609.  
  610.              ARTOOL functions are always named "artool", like so;
  611.  
  612.                        artool(int x,int y)
  613.  
  614.              where you call the artool function with x,y origin of the
  615.              graphics in the function.  The x,y origin is picked by
  616.              ARTOOL by finding the leftmost (x) and topmost (y) graphic
  617.              coordinate of all the graphics in the collection of graphic
  618.              objects.  The x,y coordinate you call the ARTOOL function
  619.              (artool(x,y)) is the x,y origin from which all other objects
  620.              will be drawn from.
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                                       Page - 10
  660.  
  661.  
  662.  
  663.  
  664.  
  665.              ARTOOL - Version 1.3                                  2/9/92
  666.  
  667.  
  668.                                        ARTSHOW
  669.  
  670.              Include with ARTOOL is a utility which will display the
  671.              contents of your ".ART" files directly to the screen.  This
  672.              may be used to review your ART files, or for creating
  673.              prototypes or slide shows.
  674.  
  675.              To use ARTSHOW do the following
  676.  
  677.                   ARTSHOW filename[.art]
  678.  
  679.                   Where filename is the filespec (wildcards ok) of the
  680.              ART files you want to display. When ARTSHOW runs it will
  681.              display each ART file an wait for a keypress before drawing
  682.              the next one.
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.                                       Page - 11
  726.  
  727.  
  728.  
  729.  
  730.  
  731.              ARTOOL - Version 1.3                                  2/9/92
  732.  
  733.  
  734.                                  Further Information
  735.  
  736.  
  737.              If you have any questions or suggestions please contact us
  738.              here at :
  739.  
  740.                            SunSet Software at 201-697-1629.
  741.  
  742.              Or if you prefer write to us at :
  743.  
  744.                                    SunSet Software
  745.                                      34 Ridge Rd
  746.                                   Oak Ridge,NJ 07438
  747.  
  748.                or
  749.  
  750.                                CompuServe   75036,1602.
  751.  
  752.  
  753.              To register for ARTOOL and receive the latest version please
  754.              fill out the order form below and send $15 to the above
  755.              address (see below on how we pay for suggestions and bug
  756.              reports).
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.                                       Page - 12
  792.  
  793.  
  794.  
  795.  
  796.  
  797.              ARTOOL - Version 1.3                                  2/9/92
  798.  
  799.  
  800.                                   Registration Form
  801.  
  802.              Remit to:            SunSet Software              Order Form
  803.                                     34 Ridge Road
  804.                                  Oak Ridge,NJ   07438
  805.  
  806.              Please send:
  807.  
  808.              ___ ARTOOL Registration and Disk Combo @ $ 15.00 ea $ ______
  809.                       (registration, program, and manual on disk)
  810.  
  811.                                                        Subtotal    ______
  812.  
  813.  
  814.              Discounts for Suggestion and Bug Reports
  815.  
  816.              Less $2 for each suggestion    <______>
  817.  
  818.              Less $4 for each Bug Report    <______>
  819.  
  820.              Total (Max $10)                <______>
  821.  
  822.              (New Jersey residents please add 6% sales tax) Tax    ______
  823.  
  824.                                                            Total $ ______
  825.  
  826.              Payment by: ( ) Check ( ) Money Order ( ) PO # _____________
  827.  
  828.              Name: _____________________________________________________
  829.  
  830.              Company:____________________________________________________
  831.              Address: ___________________________________________________
  832.                       ___________________________________________________
  833.                       ___________________________________________________
  834.              Day Phone: (______)__________ Eve: (______)_________________
  835.  
  836.  
  837.              ORDERS OUTSIDE THE US: Use check or money order drawn on US
  838.              bank in US dollars.  Sorry, no C.O.D. orders will be
  839.              accepted.
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.                                       Page - 13
  858.  
  859.  
  860.  
  861.  
  862.  
  863.              ARTOOL - Version 1.3                                  2/9/92
  864.  
  865.  
  866.                                 Suggestions ($2 Each)
  867.  
  868.              What do you want to be added or enhanced, what do want to be
  869.              deleted.
  870.              ___________________________________________________________
  871.              ____________________________________________________________
  872.              ____________________________________________________________
  873.              ____________________________________________________________
  874.              ____________________________________________________________
  875.              ____________________________________________________________
  876.              ____________________________________________________________
  877.               ___________________________________________________________
  878.              ____________________________________________________________
  879.              ____________________________________________________________
  880.              ____________________________________________________________
  881.              ____________________________________________________________
  882.  
  883.                                 Bug reports ($4 Each)
  884.  
  885.              Please list hardware using (type of cpu, video monitor, TSR
  886.              installed), a way for us to duplicate the bug - ie. what
  887.              keys where pressed in what order, or if an editor bug what
  888.              graphics where up, etc.
  889.  
  890.              ____________________________________________________________
  891.              ____________________________________________________________
  892.              ____________________________________________________________
  893.              ____________________________________________________________
  894.              ____________________________________________________________
  895.              ____________________________________________________________
  896.              ____________________________________________________________
  897.              ____________________________________________________________
  898.              ____________________________________________________________
  899.              ____________________________________________________________
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.                                       Page - 14
  924.  
  925.